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(54) Software updating method 

(57) A method for use in upgrading a resource of a 
computer from an existing version of the resource to a 
later version of the resource. The method includes the 
steps of (a) digitally storing upgrade information which 
identifies the later version and describes features of the 
later version relative to one or more earlier versions of 
the resource, (b) digitally storing in the computer infor- 
mation identifying the existing version, by computer, 
automatically determining which of the earlier versions 



is the existing version, and (c) based on the results of the 
comparing step, automatically determining, or displaying 
to a user at feast some of the upgrade information to aid 
the user in determining, whether to perform an upgrade. 
The upgrade information may be stored on a portable 
medium along with copies off the resources and the 
upgrade information may include instructions, in accord- 
ance with a predefined common syntax, for installing 
each of the resources. 
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Description 

This invention relates to automatic computer upgrading. 

The user of a computer system (e.g., a stand-aJone PC or a network) is usually concerned with maintaining maximum 
5 utility and efficiency of system resources while at the same time minimizing the cost, in time, money and frustration, of 
maintaining the system. System resources, e.g., system firmware, software applications, operating systems (OS), OS 
drivers and system partition utilities, are frequently upgraded by the manufacturer. Therefore, to effectively balance 
system utility with the costs of the system, the user frequently would have to perform a detailed analysis of the available 
upgrades and the effect those upgrades would have on the user's system. 
10 During such an analysis, the user would have to compare the version number of each system resource to that of 
its upgrade to determine whether or not an upgrade is available. When an upgrade is available, the user would have to 
understand the differences between the system version of the resource and the corresponding upgrade, as well as how 
these differences would affect (i.e., improve or diminish) the capabilities of the computer system. 

Even when the user is able to determine with accuracy the benefits of an upgrade to the system, the user is almost 
15 never able to determine how an upgrade will impact a resource that is not upgraded. It is not uncommon for an upgrade 
to reduce the ability of a resource to properly function with another resource. In addition, upgrades often exist solely to 
repair hidden bugs which may not have surfaced on the user's system, a situation in which the user almost always 
ignores the upgrade until the bug is encountered, usually resulting in lost information. 

Many resource manufacturers address some of these problems by making certain aspects of the upgrade determi- 
ne nation easier for the user. The NetWare Management System by Novell inspects network loadable modules (NLMs) on 
a network server to determine the current version of the NLM, its most recent revision level, and the revision date. Thus, 
NMS not only tells the user which resources are currently on the system, but also provides information that allows the 
user to easily determine whether or not upgrades are available. Likewise, the Frye Utilities NetWare Management pro- 
gram provides the titles and version numbers of NLMs on the server. Manufacturers also usually provide descriptions 
25 of the changes made from one version of a resource to the next. Nevertheless, despite the availability off this type of 
information, the user, in general, either never upgrades or upgrades whether it is needed or not. 

In general, in one aspect, the invention features a method for use in upgrading a resource of a computer from an 
existing version of the resource to a later version of the resource. The method includes the steps of (a) digitally storing 
upgrade information which identifies the later version and describes features of the later version relative to one or more 
30 earlier versions of the resource, (b) digitally storing in the computer information identifying the existing version, by com- 
puter, automatically determining which of the earlier versions is the existing version, and (c) based on the results of the 
comparing step, automatically determining, or displaying to a user at least some of the upgrade information to aid the 
user in determining, whether to perform an upgrade. 

Implementations of the invention include the following features. The upgrade information may be stored on a portable 
35 medium, the later version of the resource may also be stored on the portable medium, and the upgrade information may 
identify the location of the resource on the portable medium. The portable medium may be a CD-ROM, and may contain 
stored later versions of multiple resources, and upgrade information with respect to each of the resources. 

The upgrade information may be stored in the form of a database, and may include instructions for installation of 
the resource. The installation instructions may be expressed in accordance with a predefined common syntax. The 
40 resource may include a complete standalone software package, or less than all of a complete standalone software 
package. 

The upgrade may be automatically performed on a network server, or on a network client. In the latter case the 
upgrade may be performed via the network, or by automatically storing the later versions and installation instructions 
on a portable storage medium for manual installation on the client. 
45 The upgrade information may include information concerning reasons for the later version, and an indication of the 
type of change from a prior version to the later version (e.g., feature enhancement, performance enhancement, or bug 
fix). The upgrade information also may include an indication of the importance of the change from the prior version to 
the later version, and information identifying other resources that must be upgraded before the resource may be 
upgraded. 

so In general, in another aspect, the invention features supplying later versions of resources for upgrading existing 
versions, by storing copies of the resources and upgrade information which identities the later versions, describes fea- 
tures of the later versions relative to one or more earlier versions off the resource, and provides instructions, in accord- 
ance with a predefined common syntax, for installing each of the resources. The copies of the resources and the upgrade 
information may be stored on a portable storage medium or within an on-line service. 

55 Among the advantages of the invention are the following. The invention automatically determines the availability of 
upgrades to resources on a computer system. The invention may also determine the importance of each of the upgrades. 
In addition, information regarding depend ncies between upgrades is provided. As a result, th user can, with little effort, 
make an educated determination of which resources should and should not be upgraded at a particular time. Resources 



2 



EP0 703 531 A1 



to be upgraded may be selected automatically, and the upgrades may be made automatically in a network environment 
or manually using automatically generated upgrade diskettes. 

Other advantages and features will become apparent from the following description and from the claims. 
Figure 1 is a functional block diagram of a network server and a server manager, including an automatic upgrade 
5 device. 

Figure 2 is a functional block diagram of a server and a server manager daring an automatic upgrade. 

Figure 3 is a flow diagram for automatically updating resources on a network server. 

Figure 4 is a diagram of components of a management information base. 

Figures 5A-5C are templates for records in an upgrade database. 
10 Figure 5D is a functional block diagram of components of an upgrade database. 

Figure 6 is a functional block diagram off an upgrade advisor. 

Figures 7A-7B and 8 are flow diagrams for upgrade advising. 

Figures 9 and 1G are screen shots of a graphical user interface for an upgrade advisor. 

Figure 1 1 is a functional block diagram of components of a client of the network server. 
is Referring to Figure 1 , a network server 1 provides network resources 3 to a network of client computers (not shown). 
Network resources include firmware, software applications, operating systems (OS). OS drivers and hardware drivers. 
A management information base (MIB) 5 within the server 1 maintains basic descriptive information about each of the 
resources 3 available on the server 1 . Included in the MIB 5 are the name and version number of each piece of software, 
its location in the server, and the date and time of its release. The information in the MIB 5 ensures that the server 1 
20 always has a current record of the resources 3 it provides to the network. 

Upgrades 7 to the network resources 3 are provided to a server manager 2 by a distribution medium (not shown), 
such as a CD-ROM. The upgrades 7 may also be provided by an on-line service (not shown), such as a bulletin board 
service administered by a manufacturer of network resources. The basic units of the upgrades 7 are upgrade objects 
8, each of which corresponds to an individually upgradable network resource 3. The upgrade objects are grouped into 
25 upgrade packages 6 which correspond to resource 3 groupings on the server. A package 6 may contain any number of 
upgrade objects 8 (i.e., may upgrade any number of individual network resources 3), including only a single object 8. 

In addition to the resource upgrades 7, the CD-ROM contains an upgrade database 9. which stores information 
about each of the upgrade packages 6 (e.g., name and location of the package on the CD-ROM, description of the 
upgrades, and instructions for installation of the package to the server), and the individual upgrade objects 8 within each 
30 package 6. If the upgrades 7 are provided by an on-line service, the upgrade database 9 will also be provided by the 
service. 

The server manager 2 oversees the network resources 3 stored on the server 1 . An upgrade device 1 0 in the server 
manager 2 is responsible for automatically analyzing and executing the resource upgrades 7 available to the server 1 . 
When the upgrades 7 become available to the network (e.g., by inserting the CD-ROM into the server manager drive, 

35 or by logging into the on-line service), an upgrade advisor 11 in the upgrade device 10 automatically analyzes each 
network resource 3 currently on the server 1 to determine the availability and necessity of the corresponding upgrade 
7. When the analysis is complete, the upgrade advisor 1 1 presents a report and/or graphical display to the user. This 
output is in the form of upgrade recommendations, each supported by an explanation of the reasons for upgrade. The 
results may also be used to create upgrade diskettes, 

40 To determine which upgrades 7 should be installed to the server, the upgrade advisor 1 1 retrieves information about 
the MIB 5 from a server database 13 located in the server manager. The server database 13 teHs the upgrade advisor 
1 1 the location of each piece of information contained in the MIB, The upgrade advisor 1 1 supplies the location infor- 
mation to a data retriever 15, which uses it to retrieve from the MIB 5 data (MIB data) about the network resources 3. 
The upgrade advisor 1 1 then retrieves upgrade information from the upgrade database 9 and performs two types of 

45 comparisons: a) whether or not a particular upgrade package corresponds to a resource on the server, and b) whether 
or not the version number of the upgrade package matches the version number of the corresponding network resource 
(i.e, whether or not the upgrade package represents a true upgrade for the existing network resource). If the upgrade 
applies to a resource on the server and if the upgraded and current versions of the network resource do not match, the 
upgrade advisor 11 uses additional information from the upgrade database 9 to analyze the level of severity of the 

so upgrade, i.e., to determine the importance of the upgrade to the efficient operation of the server. The upgrade advisor 
is described in more detail below. 

Referring also to Figures 2 through 4, the upgrade database may also contain information about a resource (e.g., 
a driver) which is not recognized by the server manager. In this situation, the upgrade advisor places information about 
the resource (e.g. , name, version number) into a driver table 32 in the MIB 5. An agent 21 of the server manager located 

55 in the server uses this information to search for the resource (i.e., to see if the resource has been installed on the 
network). If so, the server manager creates entries for the resource in the s rver database. 

When th upgrade advisor 1 1 and/or the user have selected 1 00 the network resources 3 that need t be upgraded, 
an upgrad installer 1 7 oversees the automatic installation of the packages to the server. At th outset, the appropriate 
upgrade packages 7 are retrieved 102 from the distribution medium (or the on-line service) and supplied 1 06 to a server 
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upgrader 22 located in the upgrade installer 17. Installation instructions 20 are retrieved 104 from the database 9 and 
are supplied 106 to the server upgrader 22. The instructions are coded in a unique package scripting language (PSL), 
which can be read and executed at the time of installation. Rules of syntax for a preferred PSL are listed in Appendix A. 
In the server upgrader 22, several upgrade packages 7 and the corresponding installation instructions 20 are grouped 

5 1 08 into a "job" 1 8. Within each job 1 8, the installation instructions for every package are included in a control file 1 8a. 
The control file also includes a pre-appointed time at which the installation of the packages in the job should be carried out. 

When the job 18 is ready to be installed to the target server, the server upgrader 22 connects 109 with the server 
through a login service 24 and then sends 1 1 0 the job 1 8, including the control file 1 8a t to a staging area 1 9. The staging 
area 19 may be in the target server, in the server manager, or anywhere else in the network capable of handling the 

10 deposit and retrieval of upgrade files. Within the staging area 1 9, each package is placed into a corresponding package 
directory 71 , and the control file is stored separately. The server manager then notifies 1 1 2 the agent 21 that a job has . 
been sent to the staging area 19. When the pre-appointed time arrives 1 14, the agent .21 executes 1 16 the instructions 
in the control file, thereby installing the packages from the package directories 71 to the target network resources 3. 
The agent then deletes 1 1 7 the control file from the staging area 1 9. 

is Before the packages are installed to the targets, the agent 21 may store 1 1 5 the older revision levels of the resources 
on a local hard disk 23. As a result, the user always has access to previous versions of the resources. Maintaining old 
versions of upgraded resources allows the user to downgrade the resource, if needed, in the future. 

After the installation is complete, job status data 73 is generated 1 1 8 and temporarily stored 1 20 in a results directory 
75 in the staging area 19. The agent 21 retrieves the job status data 73 from the results directory 75 and places 122 it 

20 into a job status table 34 in the MIB 5. A results manager 26 in the upgrade installer monitors the MIB 5 for the job status 
data 73 and retrieves 124 the data as soon as it appears. The results manager 26 then sends 125 the data to a history 
manager 28, which tracks the history of upgrades on the server. The history manager 28 is responsible for providing 
126 the history information to the user (or to storage). The server upgrader 22 then cleans 128 the staging area of any 
extraneous information. Because a single copy of a package may be used to upgrade a resource on multiple servers 

25 (using multiple control files), the packages are left 130 in the staging area 19 by the server upgrader. 

Referring to Figures 5A through 5C, the upgrade database actually consists of three databases: a "Package" data- 
base 25, a "Description" database 27, and a "How_To" database 29. The Package database 25 contains the information 
which associates upgrade objects with each package, as well as the information needed to retrieve a package from the 
distribution medium (CD-ROM) and properly install the package to the server. For each upgrade package, the database 

30 maintains a unique package number 25a and a count 25b of the number of database records (i.e., upgrade objects) 
associated with the package. In addition, the version number 25c and the upgrade date 25d of the package are main- 
tained. The Package database also maintains the name 25e of the package and the location 25f of the package on the 
CD-ROM (i.e., CD drive and directory name). To enable automatic installation of the package, the database contains 
the package script 25g (the installation instructions for the package). The database also contains information regarding 

35 the dependencies between the package and other upgrade objects or packages: child dependencies 25h are the upgrade 
objects associated with a package: sibling dependencies 25j are the packages upon which a package depends; and 
parent dependencies 25i are the packages or upgrade objects which together constitute a larger package. Finally, the 
database indicates whether or not the package can be selected by the user for upgrade and whether or not the package 
can be displayed to the user through a user interface. 

40 While each upgrade distribution medium will commonly contain all upgrade packages upon which a particular 
upgrade depends, it is also likely that upgrades to a package will depend upon upgraded packages not stored on the 
distribution medium. For example, the printing capabilities of an upgraded word processor created by one vendor may 
depend upon an upgrade to a printer driver produced by another vendor. While it is unlikely that the word processor 
upgrade and the driver upgrade will be distributed on the same CD, the user should still be informed of the dependency. 

45 Therefore, the dependency information in the Package database 25 describes not only the dependencies between pack- 
ages on the CD, but also all dependencies between an upgrade package and any upgrade not available on the CD. Even 
though the unavailable upgrades cannot be automatically installed with the available upgrades, the user is nonetheless 
aware of their necessity. 

The Description database 27 stores information that describes each upgrade found in a package. Included in this 
so information are the package number 27a and record count 27b, as well as the version number 27c and date 27d of the 
upgrade. A description 27e of the change between the updated version and the previous version of the upgrade object 
is also provided. Because a server may contain any previous version of a resource, the database must maintain a 
description of the changes between each version. The description 27e includes reasons why the upgrade is necessary, 
drawing information from development release notes, test reports and field service reports. The type 27f of upgrade 
55 made to the object (e.g., feature enhancements, performance enhancements or bug fixes) and the importance 27g of 
the upgrade (e.g.. high, medium or low) ar also indicated in th Description database. 

The HowJTo database 29 supplies information which allows the upgrade advisor to compare the upgrade information 
to the MIB data (MIB items) from the server. As in the Package and Description databases, th package number 29a is 
maintained. Within the HowJTo databas , each record represents an individual piece of M IB information corresponding 
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to the particular package. Each record is identified by a record number 29b. A unique internal number 29c is assigned 
to allow the upgrade device to identify the MIB item and comparison service specified in the record. The database also 
maintains the name 29d of the MIB item maintained in the record, as well as the name 29e of the comparison servic 
which will use the MIB item to perform the comparison. 

5 The items to be compared may be string data 29f (e.g.. the name of the package) or numeric data 29g and the 
comparison serv.ce is selected accoidingly. The comparison service is also selected acceding to the type 29h of com- 
parison, us., a) whether the package applies to the server, or b) whether the upgraded version differs from the current 
version The comparison group number 29i allows the upgrade advisor to group comparison results with related results 

«, 9 «h ST"? t ° to .^ ur ! 5D : first P acka 9e 26a in the Package database 25 is linked to description records 28a' 

detail on earlier versions of the package, thus enabling the upgrade advisor to analyze the changes between ™S 
version The package 26a is also linked to the comparison records 30a. 30b. 30c ip the How To database 29 each of 
wh,ch describes the^MIB data required to compare the current version of the package to ihe upgrade. The second 
package 26b and subsequent packages in the Package database are likewise linked to the corresponding records in 
15 the Description and How_To databases. 

Referring to Figures 6 through 10, when the user initiates 200 the upgrade advisor a list box obiect 33 is create! 
202 and a Endows list *» £1 is displayed to the user. The list box o^S 33 createt 204 

each server in the network. When a server is selected 206 by the user, the corresponding server view object 35 places 
208 the server name 53 into the list box 51. The server view object 35 then creates 210 package view objects 49 to 
zo handle package information during the comparison process. u pacrage view oojects 49 to 

A package query object 43 retrieves 21 1 package data from the Package database and uses the data to create a 

-ng package, including a description of the package, pointers to the MIB check objects 37 that apply to the package and 
pointers to parent, child, and sibling packages. A MIB query object 38 retrieves MIB location information for each" MIB 
2S item from the server database 13 and then uses the information to retrieve 212 MIB data and comparison service infor- 

«?hni° m ^!^TL^I ,P ^ 1 l 0n SefViCe in,ormation identifies *» appropriate service to handle the comparison of 
each p,ece of MIB data. The MIB query object then creates 213 MIB check objects 37 responsible for handling the 
comparisons between MIB data and upgrade data. A description query object 39 uses information from the Description 
database to create 214 a description object 41 for each upgrade object contained in a package 

r T 6 " fJf!* ° bjeC !f 3re Cfeated ' 3 M ' B manager ^ 31 Amines 215 which MIB items should be retrieved 
from the selected server. A request for the MIB data is sent 216 to the data retriever (15 in Figure 1). which gathers 218 
tte requested information from the MIB in the selected server and forwards 220 the data to the list box object 33 As 
the MIB items are received by the upgrade advisor, the list box object 33 identifies 222 the server which sent the data 
and forwards 224 the data to the appropriate server view object 35. where the MIB items are queued 226 When all 

STS^d r6CeiV ^ fr ° m thS SerVer> <he SSrVer View 0bject 35 sends 228 M'B data to the MIB manager object 
31 The i MIB manager object then identifies 230 the appropriate MIB check object 37 to process each piece of MIB data 
and distributes 232 the data accordingly. piece onvueoata 

As the MIB data makes its way from the server to the MIB check object, the corresponding upgrade description 
information ,s retoeved 234 from the Description database by the description query ot^ect 39. Each uplrade description 

SSJ^ 5 h 6 T eSP ° nding ^^"^^^^descripttonc^ects^.eS package^ 
45 collects 238 the upgrade descriptions pertaining to the package. The package object 45 then-sends 240 each piece 
of upgrade data to the appropriate MIB check object 37 for comparison to corresponding MIB data 

Once the MIB check objects 37 have received the appropriate MIB data and upgrade data, the data is sent 244 to 
the appropriate comparison service 47. according to the comparison information retrieved from the MIB After the data 

" ol 246 ' the comparison ***** 47 returns 248 a comparison result to the MIB check object, where the result 
is storocl 250. 

In order to display or report upgrade advice to the user, the server view object 35 requests 300 package status 

jSS° n i° m ^£S?u 49 ' The PaCk39e MeW ° biect 49 in turn *«*»** 302 the **« information 

from the package object 45. Using pointers, the package object 45 determines 304 which MIB check objects 37 contain 

the comparison results for me corresponding package. The package object then retrieves 306 the results and combines 
308 them to determine package status (i.e.. whether or not the package applies to the server, and whether the package 
" ee< l o b « mraded 00 SerVer) " 0nce * 6 8131118 0< ^ P 30 ^ is determined, the package status information is 
passed 3 1 0 to the package .view object 49. If the status information indicates that the package applies 312 to the server 

' dS I 14 ^ P 3 ^ 96 55 10 4,16 8efVer 53 in the li8t box 51 - ™« sta * s in *>™*>" is then 
passed 316 to the server view object 35, where it is displayed 318 to the user in the list box 51 

The importance of an upgrade 57 (high, medium, low) is displayed to the user through color coded vidual objects 

S ( JL ' ^H 1 - 1,16 r f aS ° nS 59 fof the UP9rade (i e ' up 9 rade description) are also displayed in the list box 
51. When requested by the user (e.g., with a "Details" button 60). additional d tails about the upgrade are displayed 
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320 in a detail window 65. In addition to displaying the output of the upgrade advisor, a report may be generated 322 
by the upgrade advisor. The upgrade advisor may also store 324 the status results. 

Referring to Figure 11 , the upgrade advisor and installer may also be used to analyze the availability of upgrades 
and generate upgrade jobs for individual clients 80 connected to the server. In this situation, the client, like the server, 
5 contains a MIB 81 which maintains information about the resources 83 currently installed on the client. When the user 
invokes the upgrade advisor, the MIB data is retrieved from the MIB 81 and the comparisons are carried out as described 
above. 

The client resources 83 may then be upgraded in two ways: automatically through the upgrade installer, or manually 
with upgrade diskettes 85 automatically created by the upgrade device. If automatic update is chosen, the upgrade 

w installer builds the selected upgrade packages and installation instructions into a job (as discussed above), which is 
transferred into a staging area. An agent 87 in the client 80 is then notified that a job has been placed in the staging 
area, and the agent installs the packages in the job according to the installation instructions. Alternatively, the client may 
be programmed to search the staging area at specific times (e.g., start-up) for jobs it needs to install. 

if manual update is chosen, the packages selected for upgrade are stored to a diskette 85, along with the corre- 

is spending installation instructions. When alt of the packages have been placed onto the diskette, the user places the 
diskette into a disk drive (not shown) on the client, and the agent automatically installs the packages according to the 
installation instructions. 

As an example of the operation of the upgrade advisor and upgrade installer, assume that the distribution medium 
contains an upgrade package called Novell Programs. Within the Novell Programs package is an upgrade object corre- 
20 sponding to each of the NetWare drivers installed to the target server. When the distribution medium is inserted into the 
drive, the upgrade advisor reads information about the Novell Programs package from the Package database. The 
upgrade advisor then retrieves from the Description database description information for the upgrade objects in the 
package. The records corresponding to each upgrade object are then read from the How_To database and compared 
to the description information. 

25 As shown in the chart below, the first record for the Novell Programs package contains information about the oper- 
ating system running on the server. The first entry in the record is the name f cpqHoName") of the MIB data for the 
records. This entry causes the upgrade advisor to retrieve the name of the operating system that the server is running. 
The second entry informs the upgrade advisor that a "stringcompare" comparison service will be used to compare the 
upgrade and MIB data. The third and fourth entries pass the corresponding description information to the comparison 

30 service. For record number 1 , the MIB data is compared to the string "NetWare". Since string data is to be compared, 
the "numeric data" entry is ignored. The last entry for the record informs the upgrade advisor that the type of comparison 
to be performed is a determination of whether or not the NetWare OS applies to the server, i.e., if the OS runs on the 
server. 

The second record contains the information necessary to determine whether or not the netware "NPFC" software 
35 is available on the server. If so. the information in the third record enables a comparison of the version number of the 
upgrade with the version number on the server. 



Record # 


mib data 


comparison service 


string data 


numeric data 


type 


1 


cpqHoName 


stringcompare 


Netware 


N/A 


applies 


2 


cpqSWVerName 


stringcompare 


NPFC 


N/A 


applies 


3 


cpqSWVerVersion 


versioncheck 






version 



45 

When the upgrade advisor receives all of the comparison results from the comparison services, the results are used, 
first, to determine whether or not the Novell Programs package is an upgrade which can be installed to the server and, 
second, to advise the user of the importance of the upgrade. Assuming that an upgrade to the Novell Programs package 

so is both available and desired, the user selects the package as one to be upgraded. The upgrade installer is then invoked. 
The upgrade installer retrieves the Novell Program's package from the distribution medium and the corresponding 
installation instructions from the How_To database. The package and instructions are then incorporated into a job, which 
includes a command to run the job at midnight. The job, including the Novell Programs package and the control file, is 
copied into the staging area and the agent on the target server is notified of its presence. When the agent looks at the 

55 job, it sees the command to run the job at midnight and waits until that time arrives. At midnight, the agent calls an install 
application to automatically install the Novell Programs package. When the installation is complete, the agent stores 
results information, including the name of th job and the time at which it was executed, into the job status table of the 
MIB. The upgrade installer then retrieves this information and provides it to the user. 
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Other embodiments of the invention are within th scope of the following claims. 

Package Script Language 

A Package Script Language (PSL) is defined that should make it easier for 
package owners to develop installation scripts for their products. 

Commands 

The installer will look for a .PSL file and begin executing it. PSL 
commands are: 

MKOIR [/err] < directory > 

COPY {/u] l/err] < source > <destination> 

DELETE [/err] < source > < destination > 

RUN Jos] [/err] < executable > [...parameter list... 1 

Where, 

/u - add the opposite of this command (or copy < destination > 

< source > ) to the UNDO.P5L file (see below) 

/err - on error, stop script processing and report a package failed 
status (run undo.psl and report failed in job status table.) 

< source > - source file to copy - can be any number of 
specifications: 

d:fldirectory\J< filename > 

\ \server\share \[direaory\]< filename > 

SYSPABT:f\direaory\}<ftlenme> 

<destinacion> - destination for file - see specs for <x> 

os - defined as NT (WinNT), 02 (OS/2), SC (SCO UNIX), UW 
(UnixWare), and NW (NetWare). 
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For COPY, any file attributes will be preserved but ignored (i.e., 
copying over a Readonly doesn't cause an error). 



Section Headings 

Each PSL is broken into sections designated by a section heading. Then 
are four special section heading names that the script processor will look to 
execute. The headings are executed in this order: Main, EISA ID, OS, 
and User Defined. 

[Main] - section is run on all machines 

[EKA:eisaID] - section is executed if board with ID specified is installed. 
EISA ID is specified: CPQXXXX where X can be an alphanumeric 
character or "?" to match any alphanumeric in that position. 

[WinNT ( NetWare | UNIX | OS/2] - section should be run on machine 
if specified OS is running. 

[< user defined > ] - a user defined section. It must be immediately 
followed by: 

DISCOVER Jos] « < executable > - executable should return 1 for 
execute remainder of section, or 0 for skip section. OS is defined as NT 
(WinNT), 02 (OS/2), SC (SCO UNIX), UW (UnixWare), and NW 
(NetWare). 

[UNDO BEG] - this section defines the <undo> .PSL file. The presence 
of this section causes the interpreter to create an <undo> .PSL file based 
on the naming. The [undo] section contains: 

filename = < undo > .psl - or the name of the undo file tabe 
created, 

<any other text> - this text is added to the undo file untouched, 
[UNDO_BEG] - the end of the undo section. 



Claims 



A method for use in upgrading a resource of a computer from an existing version of the resource to a later version 

of the resource, comprising 

digitally storing upgrade information which identifies the later version and describes features of the later 

v rsion relative to one or more earlier versions of th resourc , 

digitally storing in th comput r information identifying the existing version, 

by computer, automatically determining which of the earlier versions is th existing version, and 
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based on the results of th comparing step, automatically determining, or displaying to a user at least some 
of the upgrade information to aid the user in determining, whether to perform an upgrade. - 

2. The method of claim 1 wherein the upgrade information is stored on a portable medium, the later version of the 
5 resource is also stored on the portable medium, and the upgrade information identifies the location of the resource 

on the portable medium. 

3. The method of claim 2 wherein the portable medium comprises a CD-ROM. 

jo 4. The method of claim 2 wherein the portable medium contains stored later versions of multiple resources, and 
upgrade information with respect to each of the resources. 

5. The method of claim 1 wherein the upgrade information is stored within an on-line service. 

is 6. The method of claim 1 wherein the upgrade information is stored in the form of a database. 

7. The method of claim 1 wherein the upgrade information further comprises instructions for installation of the resource. 

8. The method of claim 7 wherein the installation instructions are expressed in accordance with a predefined common 
20 syntax. 

9. The method of claim 1 wherein the resource comprises a complete standalone software package. 

10. The method of claim 1 wherein the resource comprises less than all of a complete standalone software package. 

25 

11. The method of claim 1 further comprising automatically performing the upgrade on a network server. 

12. The method of claim 1 1 wherein automatically performing the upgrade on the network server comprises 

storing on a storage medium the existing version of the resource, and 
30 replacing on the server the existing version of the resource with the upgrade. 

13. The method of claim 1 further comprising automatically performing the upgrade on a network client 

14. The method of claim 13 wherein the upgrade is performed via the network. 

35 

15. The method of claim 13 wherein automatically performing the upgrade on the network client comprises 

storing on a storage medium the existing version of the resource, and 
replacing on the client the existing version of the resource with the upgrade. 

40 1 6. The method of claim 1 3 wherein the upgrade is performed by automatical ly storing the later versions and installation 
instructions on a portable storage medium for manual installation on the client. 

1 7. The method of claim 1 wherein the upgrade information includes information concerning reasons for the later version. 

45 18. The method of claim 1 wherein the upgrade information includes an indication of the type of change from a prior 
version to the later version. 

1 9. The method of claim 1 8 wherein the type may include feature enhancement, performance enhancement, or bug fix. 

so 20. The method of claim 1 wherein the upgrade information includes an indication of the importance of the change from 
the prior version to the later version. 

21. The method of daim 1 wherein the upgrade information includes information identifying other resources that must 
be upgraded before the resource may be upgraded. 

55 

22. A method of supplying later versions of resources for upgrading existing versions comprising storing, on a portable 
medium, copies of th resources and upgrade information which identifies th later versions, describes features of 
the later versions relative to one or more arlier v rsions of the resourc , and provides instructions, in accordance 
with a predefined common syntax, for installing each of the resources. 
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23. The method of claim 22 wherein the upgrade information includes information concerning reasons lor the later 
version. 

24. The method of claim 22 wherein the upgrade information includes an indication of the type of change from a prior 
version to the later version. 

25. The method of claim 22 wherein the upgrade information includes information identifying other resources that must 
be upgraded before the resource may be upgraded. 

26. The method of claim 22 wherein the copies of the resources and the upgrade information are stored on a portable 
medium. 

27. The method of claim 22 wherein the copies of the resources and the upgrade information are stored within an on- 
line service. 

28. A method for use in upgrading a resource of a computer from an existing version of the resource to a later version 
of the resource, comprising 

digitally storing, on a portable medium, the later version of the resource and upgrade information which 
identifies the later version, 

describes features of the later version relative to one or more earlier versions of the resource, 
identifies the location of the resource on the portable medium, 
provides instructions for installation of the resource, 
describes reasons for the later version, 

indicates the type of change from a prior version to a later version, and 
indicates the importance of the change from a prior version to the later version, 
digitally storing in the computer information identifying the existing version, 
by computer, automatically determining which of the earlier versions is the existing version, 
based on the results of the comparing step, automatically determining, or displaying to a user at least some 
of the upgrade information to aid the user in determining, whether to perform an upgrade, and 
automatically performing the upgrade. 
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